home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xt / XtAppAddSignal.z / XtAppAddSignal
Encoding:
Text File  |  2002-10-03  |  4.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXttttAAAAppppppppAAAAddddddddSSSSiiiiggggnnnnaaaallll((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666)))) XXXXttttAAAAppppppppAAAAddddddddSSSSiiiiggggnnnnaaaallll((((3333XXXXtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XtAppAddSignal, XtRemoveSignal, XtNoticeSignal - register
  10.           and remove a signal source
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           XtSignalId XtAppAddSignal(_a_p_p__c_o_n_t_e_x_t, _p_r_o_c, _c_l_i_e_n_t__d_a_t_a)
  14.                 XtAppContext _a_p_p__c_o_n_t_e_x_t;
  15.                 XtSignalCallbackProc _p_r_o_c;
  16.                 XtPointer _c_l_i_e_n_t__d_a_t_a;
  17.  
  18.           void XtRemoveSignal(_i_d)
  19.                 XtSignalId _i_d;
  20.  
  21.           void XtNoticeSignal(_i_d)
  22.                 XtSignalId _i_d)
  23.  
  24.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  25.           _a_p_p__c_o_n_t_e_x_t
  26.                     Specifies the application context.
  27.  
  28.           _c_l_i_e_n_t__d_a_t_a
  29.                     Specifies the argument that is to be passed to the
  30.                     specified procedure when a signal has been raised.
  31.  
  32.           _i_d        Specifies the ID returned from the corresponding
  33.                     _X_t_A_p_p_A_d_d_S_i_g_n_a_l call.
  34.  
  35.           _p_r_o_c      Specifies the procedure that is to be called when
  36.                     the signal has been raised.
  37.  
  38.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  39.           The _X_t_A_p_p_A_d_d_S_i_g_n_a_l function initiates a mechanism for
  40.           handling signals within the context of the Intrinsics. Prior
  41.           to establishing an operating system dependent signal handler
  42.           the application may call _X_t_A_p_p_A_d_d_S_i_g_n_a_l and store the
  43.           returned _i_d in a place accessible to the signal handler.
  44.  
  45.           Upon receipt of a signal from the operating system, the
  46.           application may call _X_t_N_o_t_i_c_e_S_i_g_n_a_l passing the _i_d returned
  47.           by the call to _X_t_A_p_p_A_d_d_S_i_g_n_a_l.
  48.  
  49.           _X_t_N_o_t_i_c_e_S_i_g_n_a_l is the only Intrinsics function that can
  50.           safely be called from a signal handler. If _X_t_N_o_t_i_c_e_S_i_g_n_a_l is
  51.           called multiple times before the Intrinsics are able to
  52.           invoke the registered callback, the callback is only called
  53.           once. Logically the Intrinsics maintain ``pending'' for each
  54.           registered callback. This flag is initially _F_a_l_s_e and is set
  55.           to _T_r_u_e by _X_t_N_o_t_i_c_e_S_i_g_n_a_l; the Intrinsics invoke the
  56.           callback whenever the flag is _T_r_u_e, and the flag is set to
  57.           _F_a_l_s_e just before the callback is invoked.
  58.  
  59.           The _X_t_R_e_m_o_v_e_S_i_g_n_a_l function is called to remove the
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXttttAAAAppppppppAAAAddddddddSSSSiiiiggggnnnnaaaallll((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666)))) XXXXttttAAAAppppppppAAAAddddddddSSSSiiiiggggnnnnaaaallll((((3333XXXXtttt))))
  71.  
  72.  
  73.  
  74.           specified Intrinsics signal handler. The client should
  75.           disable the source of the signal before calling
  76.           _X_t_R_e_m_o_v_e_S_i_g_n_a_l.
  77.  
  78.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  79.           XtAppAddTimeOut(3Xt),XtAppAddInput(3Xt),XtAppAddWorkProc(3Xt)
  80.           _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s - _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  81.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.